home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / UNDERLN.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  43 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Underline( cWhat ) --> cString
  8.  
  9. PARAMETERS:
  10.  
  11. cWhat : String to print and then underline
  12.  
  13. SHORT:
  14.  
  15. Underline print data as it is sent to the printer.
  16.  
  17. DESCRIPTION:
  18.  
  19. _Underline() is a printing function that prints its text string parameter
  20. and then backs up and underlines it.
  21.  
  22. This is actually done in reverse order.  The @ Say statement must have
  23. an argument to avoid a run-time error.  Thus, this function returns writes
  24. the underline to the length of the text parameter and then returns
  25. that parameter to satisfy the needs of the @ SAY statement.
  26.  
  27. NOTE:
  28.  
  29. If combined with the _Bold() function, the _Bold() function must contain
  30. the _Underline() function:
  31.  
  32. @ prow(),pcol() say _Bold(_Underline('BOLD AND UNDERLINED'))
  33.  
  34. This causes the Bold to be printed, returning the original parameter
  35. to _Underline() which underlines, which in turn returns the original
  36. parameter to satisfy the @ SAY statement.
  37.  
  38. EXAMPLE:
  39.  
  40. @ PROW(),PCOL() SAY _Underline('THIS IS UNDERLINED')
  41.  
  42. ******************************************************************************/
  43.